home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / MrmFetchWidgetOverride.z / MrmFetchWidgetOverride
Encoding:
Text File  |  2002-10-03  |  6.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVMMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee - Fetches any indexed (UIL named)
  10.           application widget.  It overrides the arguments specified
  11.           for this application widget in UIL
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           #include <Mrm/MrmPublic.h>
  15.           CCCCaaaarrrrddddiiiinnnnaaaallll MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee(
  16.           MMMMrrrrmmmmHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd,
  17.           SSSSttttrrrriiiinnnngggg iiiinnnnddddeeeexxxx,
  18.           WWWWiiiiddddggggeeeetttt ppppaaaarrrreeeennnntttt____wwwwiiiiddddggggeeeetttt,
  19.           SSSSttttrrrriiiinnnngggg oooovvvveeeerrrrrrrriiiiddddeeee____nnnnaaaammmmeeee,
  20.           AAAArrrrggggLLLLiiiisssstttt oooovvvveeeerrrrrrrriiiiddddeeee____aaaarrrrggggssss,
  21.           CCCCaaaarrrrddddiiiinnnnaaaallll oooovvvveeeerrrrrrrriiiiddddeeee____nnnnuuuummmm____aaaarrrrggggssss,
  22.           WWWWiiiiddddggggeeeetttt ****wwwwiiiiddddggggeeeetttt,
  23.           MMMMrrrrmmmmTTTTyyyyppppeeee ****ccccllllaaaassssssss);
  24.  
  25.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  26.           This page documents Motif 2.1.
  27.  
  28.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.           The MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee function is the extended version
  30.           of MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt.  It is identical to MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt,
  31.           except that it allows the caller to override the widget's
  32.           name and any arguments that MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttwould otherwise
  33.           retrieve from the UID file or one of the defaulting
  34.           mechanisms.  That is, the override argument list is not
  35.           limited to those arguments in the UID file.
  36.  
  37.           The override arguments apply only to the widget fetched and
  38.           returned by this function.  Its children (subtree) do not
  39.           receive any override parameters.
  40.  
  41.           _h_i_e_r_a_r_c_h_y__i_d
  42.                     Specifies the ID of the UID hierarchy that
  43.                     contains the interface definition.  The value of
  44.                     _h_i_e_r_a_r_c_h_y__i_dwas returned in a previous call to
  45.                     MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy.
  46.  
  47.           _i_n_d_e_x     Specifies the UIL name of the widget to fetch.
  48.  
  49.           _p_a_r_e_n_t__w_i_d_g_e_t
  50.                     Specifies the parent widget ID.
  51.  
  52.           _o_v_e_r_r_i_d_e__n_a_m_e
  53.                     Specifies the name to override the widget name.
  54.                     Use a NULL value if you do not want to override
  55.                     the widget name.
  56.  
  57.           _o_v_e_r_r_i_d_e__a_r_g_s
  58.                     Specifies the override argument list, exactly as
  59.                     given to XXXXttttCCCCrrrreeeeaaaatttteeeeWWWWiiiiddddggggeeeetttt(conversion complete and so
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVMMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                     forth).  Use a NULL value if you do not want to
  75.                     override the argument list.
  76.  
  77.           _o_v_e_r_r_i_d_e__n_u_m__a_r_g_s
  78.                     Specifies the number of arguments in
  79.                     _o_v_e_r_r_i_d_e__a_r_g_s.
  80.  
  81.           _w_i_d_g_e_t    Returns the widget ID of the created widget.
  82.  
  83.           _c_l_a_s_s     Returns the class code identifying MRM's widget
  84.                     class.  Literals identifying MRM widget class
  85.                     codes are defined in the include file
  86.                     MMMMrrrrmmmm////MMMMrrrrmmmmPPPPuuuubbbblllliiiicccc....hhhh.
  87.  
  88.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  89.           This function returns one of the following status return
  90.           constants:
  91.  
  92.           MMMMrrrrmmmmSSSSUUUUCCCCCCCCEEEESSSSSSSS
  93.                     The function executed successfully.
  94.  
  95.           MMMMrrrrmmmmBBBBAAAADDDD____HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY
  96.                     The hierarchy ID was invalid.
  97.  
  98.           MMMMrrrrmmmmNNNNOOOOTTTT____FFFFOOOOUUUUNNNNDDDD
  99.                     The widget was not found in UID hierarchy.
  100.  
  101.           MMMMrrrrmmmmFFFFAAAAIIIILLLLUUUURRRREEEE
  102.                     The function failed.
  103.  
  104.      RRRREEEELLLLAAAATTTTEEEEDDDD
  105.           MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy(3), MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt(3).
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.